package cn.edu.gxu.oas.module.run.service.record;

import jakarta.validation.*;
import cn.edu.gxu.oas.module.run.controller.admin.record.vo.*;
import cn.edu.gxu.oas.module.run.dal.dataobject.record.RecordDO;
import cn.edu.gxu.oas.framework.common.pojo.PageResult;

import java.time.LocalDateTime;
import java.util.List;

/**
 * 跑步记录 Service 接口
 *
 * @author 源码
 */
public interface RunRecordService {

    /**
     * 创建跑步记录
     *
     * @param createReqVO 创建信息
     * @return 编号
     */
    Long createRecord(@Valid RecordSaveReqVO createReqVO);

    /**
     * 更新跑步记录
     *
     * @param updateReqVO 更新信息
     */
    void updateRecord(@Valid RecordSaveReqVO updateReqVO);

    /**
     * 删除跑步记录
     *
     * @param id 编号
     */
    void deleteRecord(Long id);

    /**
     * 获得跑步记录
     *
     * @param id 编号
     * @return 跑步记录
     */
    RecordDO getRecord(Long id);

    /**
     * 获得跑步记录分页
     *
     * @param pageReqVO 分页查询
     * @return 跑步记录分页
     */
    PageResult<RecordDO> getRecordPage(RecordPageReqVO pageReqVO);

    /**
     * 获取跑步记录列表
     *
     * @param reqVO 查询条件
     * @return 跑步记录列表
     */
    List<RecordDO> getRecordList(RecordPageReqVO reqVO);

    /**
     * 根据学生ID获取跑步记录列表
     *
     * @param studentId 学生ID
     * @return 跑步记录列表
     */
    List<RecordDO> getRecordListByStudentId(Long studentId);

    /**
     * 根据学生ID和时间范围获取跑步记录列表
     *
     * @param studentId 学生ID
     * @param startTime 开始时间
     * @param endTime 结束时间
     * @return 跑步记录列表
     */
    List<RecordDO> getRecordsByStudentIdAndTimeRange(Long studentId, LocalDateTime startTime, LocalDateTime endTime);
}